Mac Expert 1995 Winter/Mac Expert - Winter 95.iso/Les fichiers/Communications/Internet/MacPost Servers 1.1.4 ƒ/Server Install 95-03-12.dp/Server Install 95-03-12.dp

Common Ground | 1995-03-13 | 134.2 KB | 740 lines | [APPL/CGSL]

N Helvetica Narrow
+k(!Lund University Computing Center
Computer Advisory Department
    Helvetica
How to
install and administrate
the MacPost Server
System requirements
Palatino
6Macintosh (with 68020 processor or better, or PowerPC)
 At least 4MB RAM (8MB preferred)
    Hard disk
LApple System Software ver 7.0 or later (we have only tested with System 7.5)
"Ethernet card, with installer disk
8MacTCP ver 1.1 or later (we have only tested with 2.0.6)
0MacPost distribution disk (with client software)
#a text editor (SimpleText or other)
ResEdit
well-connected
 SMTP server on your network
a little luck
Before you start
]Please read the entire documentation before you install or update the MacPost server. You can
1find additional information in the Release Notes.
About this version
XThis is the first version that is available both as 68K apps and as native PowerPC apps.
Server installation
c1) Install the latest version of the System Software. Don
t install any non-Apple extensions in the
FSystem Folder unless you are completely sure that they wont interfere.
Y2) Install your ethernet card (both hardware and software). See the accompanying manuals.
WVerify that the connection works (eg. in the Chooser). The Network Control Panel should
Hnormally be set to EtherTalk to put the MacPost server on your backbone.
[3) MacPost requires MacTCP. Since it only runs on one machine, a single user license is OK.
](MacTCP
is included with System 7.5. It is also available separately from Apple dealers). See
Uthe MacTCP manuals for information on how to install and configure it. You must setup
ZMacTCP in a way that gives the server Mac a fixed IP number. Otherwise, other SMTP Clients
1will not be able to find the MacPost SMTP Server.
Palatino
%\We strongly recommend that you install an ethernet card in the server. MacTCP does work over
]LocalTalk and MacPost should be able to work that way, but we have not tested it and does not
support it.
NVerify that MacTCP works (eg. with NCSA Telnet or Mosaic) before you continue.
[4) Copy the MacPost Server folder to your hard disk. Open the folder, and select the server
Zicons (AT Server, SMTP Server, and SMTP Client). Make them startup applications by putting
.aliases of them in the
Startup Items
 folder.
\5) Open and edit the Preferences document (found in the MacPost Server folder) with ResEdit.
DThe changes should reflect your network (IP numbers, domains, etc.)
 Domain Name
 Internet domain name for MacPost
    Example:
macpost.lu.se
 SMTP Gateway
7IP name (or number) for
well connected SMTP server(s)
:You may specify several hosts (separate them with commas)
    Example:
nomina.lu.se,gemini.ldc.lu.se
 TimeZone
"Time Zone String (relative to GMT)
    Example:
+0100
 AppleTalk Name
Name of MacPost Server
    Example:
MacPost
 # of SMTP Services
4Max # of simultaneous connections to the SMTP Server
9(only one is active at any given time, others are queued;
/allocate around 80kB extra for each beyond two)
    Example:
\Be sure to quit and restart the relevant server(s) after you make changes to the Preferences
    document.
^7) Reboot! The MacPost Servers should start. Look in the log windows for any cryptic messages!
^The log files are saved in the MacPost Server folder. They are ASCII files, and can be read by
any word processor.
aIt is important that you look for fatal errors in the log files after each restart of the MacPost
Servers.
]8) Your new domain must be registered at your central mail system. If you skip this step, you
t get any mail at all! All mail, even from one MacPost user to another, is handled by a well-
connected SMTP-server.
    Helvetica
Server upgrade
]In this version, unread mail is stored in a 256 folders within the Unread Mail folder. If you
Aupgrade from  a previous version, be sure to make a backup first.
About version numbers
^We suggest that that you use the latest versions of system software (currently 7.5) and MacTCP
a(currently 2.0.6) on the MacPost server. Also use the latest version of network software/ethernet
adrivers. For Apple ethernet cards, use Network Software Installer (currently 1.5). We do not test
$compatibility with earlier versions.
Times
MacPost 1.1.2
March 12, 1995
page
2 of 12
    Helvetica
53A word about the installation of the MacPost Client
Palatino
ZMacPost Clients must be on the same AppleTalk internet as the MacPost Server. An AppleTalk
Uinternet may consist of any mix of LocalTalk, EtherTalk, TokenTalk, etc connected via
ZAppleTalk bridges (Shiva FastPath, GatorBox, AppleTalk Internet Router, Liaison, etc). The
<MacPost Client does not require ethernet, tcp/ip, or MacTCP.
*Drop the system extension document (INIT)
Listener
)*(onto the system folder icon (this should
cplace it in the Extensions folder). Copy the MacPost application to the hard disk (or file server).
_Reboot, start the MacPost application, select the MacPost Server you would like to use, and log
bIf problems occur, verify (eg. by running Inter
Poll at the client Mac) that the MacPost Server is
3running (look for a device with type
MacMailServer
DThe MacPost application creates a folder in the Preferences folder.
MacPost Preferences
keeps
ainfo about which server to use, username (if any), password (if any), and a few other things. The
Address Book
)DQis a plain text file used to keep the address book. You can edit it with any text
eeditor, incl. the one built-in in MacPost. Optionally, signature file and log files are placed in the
same folder.
^The client requires System 6.0 or later and AppleTalk ver 48 or later. System 6.0 requires the
^128K ROMs or later  (I think), so you must use a Macintosh Plus or later. Note that the server
requires system 7.
*- Configurating the MacPost Client
bNormally, the first time the MacPost client is started it searches for servers in all zones on the
aAppleTalk internet. It is possible to specify that it should only search in one zone. To do this,
>put the zone name into
 #132 in the MacPost application.
[If your native language has
special
 characters (like
), then you may want to
)configure the MacPost Client application
before
) $you distribute it to your end users.
[First some background: In Sweden, as well as in many other European countries, we have more
`letters than A-Z. Specifically we use
 as letters, and in the Swedish version of
WASCII, they have the same ASCII codes as }, {, |, ], [, \ have in the US ASCII version.
\When a mail is sent via MacPost, the Mac ASCII (8-bit) is translated via a translation table
Dresource to US ASCII (7-bit). The translation table is just an array
Courier
,type transTableType = array [0..255] of char
$and the translation is performed via
4translatedChar := transTable[ord (untranslatedChar)]
aA similar translation is performed in the other direction. Both those translation table resources
]must be present, and they must be exactly 256 bytes in length. The resources should be in the
Listener extension.
A (Swedish) example:
[When a user sends a mail containing
sbord
 it is actually converted to
Sm|rg}sbord
bby the MacPost client before it is sent on to the MacPost server. If the receiver of the mail uses
_MacPost, the receiving MacPost client converts it back to
sbord
. If the receiver uses a
Times
MacPost 1.1.2
March 12, 1995
page
3 of 12
Palatino
%[7-bit terminal (configured for Swedish ASCII), it is also correctly shown as
sbord
aAn English-speaking user is likely to not want this translation. However, since the Mac use 8-bit
bchars and most other systems don
t (or at least they use a different 8-bit encoding), all outgoing
bmail has to be converted to 7-bit. We have provided resources for this. The translation tables has
^the added benefit (even for US users) that you can paste in or write anything without thinking
Aabout if the characters are present in the 7-bit US ASCII or not.
ZWe support translation tables for several countries/languages. MacPost comes preconfigured
'with tables for US English and Swedish.
7The translation table resources currently included are:
, #1000,
US 8 bit-> 7 bit
, #2000,
7 bit -> US 8 bit
, #1007,
Swedish 8 bit-> 7 bit
, #2007,
7 bit -> Swedish 8 bit
_Those actually used depend on the
CountryCode
 field in the
 #1 resource in the Listener
Yextension (see Macintosh Technical Note #189, available from APDA) in the Listener. Valid
Vcountry codes are defined in Inside Macintosh, Volume 1, page 499 (Inside Macintosh is
Upublished by Addison-Wesley). Given the CountryCode,
 #1000+CountryCode is used
Ofor
8 bit -> 7 bit
 and
 #2000+CountryCode is used for
7 bit -> 8 bit
WThe US version of MacPost is preconfigured with CountryCode=0, and uses resources #1000
Land #2000. The Swedish version, with CountryCode=7, uses ID #1007 and #2007.
    Helvetica
Localized file names
+The following document names are localised:
Swedish name
English name
    Lyssnaren
Listener
    Adressbok
Address Book
Signatur
    Signature
MacPosts inst
llningar
MacPost Preferences
MacPosts mottagna brev
MacPost Receive Log
MacPosts skickade brev
MacPost Send Log
Be sure not to have both
    Lyssnaren
Listener
)*$in the system folder! If you rename
MacPost
Preferences
)70, then you must modify
 resources in both
Listener
MacPost
. You should
Zalso modify
 and
 resources, although it is not strictly necessarily to do so.
Server commands
VThe server is managed with server commands. A command is a (human-readable) text file.
WThere are stationaries for common commands in the
Mailboxes
 folder. After editing the
Jcommand file, save a copy in the
To AT Server
 folder. Be sure to save a
of the command
Zfile, since it is automatically deleted when the command is completed. After each command,
0look in the AT Server console window for errors.
XWe recommend using SimpleText for editing commands. If you use a word processor, be sure
to save as text only (ASCII).
Times
MacPost 1.1.2
March 12, 1995
page
4 of 12
Palatino
3]Commands cannot be completed if the command file is open in an application (like SimpleText).
CTherefore, after saving the command file you must close the window.
    Helvetica
To add users
Use the file
New User
(found in folder
)X    Mailboxes
)10). Edit it. The format is shown below. Then save
it in the
To AT Server
)EKfolder. The users are added to MacPost
s database, and the file is deleted.
Syntax:
Courier
Command from Manager
New User
user 1
password 1
user 2
password 2
Example:
Command from Manager
New User
steve
early
"To add users (with personal names)
Use the file
New Realuser
Syntax:
Command from Manager
New Realuser
personal name
user name
password
To delete users
KThe procedure is very similar to the one given in
New User
. Use the file
Delete User
instead.
Syntax:
Command from Manager
Delete User
user 1
user 2
Example:
Command from Manager
Delete User
steve
Times
MacPost 1.1.2
March 12, 1995
page
5 of 12
    Helvetica
To send a broadcast
Palatino
Use the file
)>    Broadcast
Syntax:
Courier
Command from Manager
    Broadcast
Message
line)
user 1
user 2
\If no users are given, all users will receive the message. The message is not a mail; it is
$immediately displayed on the screen.
To change passwords
Use the file
Set Password
Syntax:
Command from Manager
Set Password
user 1
password 1
user 2
password 2
[It is possible for the user to change password via the client software. The primary use of
Password
)1Wis to help users that have forgotten their password. BTW, passwords are case-sensitive,
3and they are neither sent nor stored in clear text.
*+!To set a personal name for a user
Use the file
Set Realname
)BJ. Note that it is possible for a user to set or modify a personal name via
the client software.
Syntax:
Command from Manager
Set Realname
user name
personal name
#To set a forward address for a user
Use the file
Set Forward
)<L. Note that it is possible for a user to set or modify a forward address via
bthe client software. The forward addess can be any valid address (i.e. it has not to be an address
on the MacPost server).
Syntax:
Command from Manager
Set Forward
user name
Times
MacPost 1.1.2
March 12, 1995
page
6 of 12
Courier
forward address
Palatino
    Helvetica
$To set a reply to address for a user
Use the file
Set ReplyTo
);M. Note that it is possible for a user to set or modify a reply to address via
the client software.
Syntax:
Command from Manager
Set ReplyTo
user name
reply to address
*To remove all unread mail items for a user
Use the file
Purge
Syntax:
Command from Manager
Purge
user 1
user 2
To get statistics
dIssue this command to get statistics for the server. The result is a tab-delimited text file (in the
To Manager
)>Ufolder) with (in order): user id, user name, personal name, reply to address, forward
`address, last login date, last login time, # of unread mail, # of mail sent, # of mail received.
Use a copy of the file
Get Statistics
Syntax:
Command from Manager
Get Statistics
To reset the statistics
Use a copy of the file
Reset Statistics
Syntax:
Command from Manager
Reset Statistics
To backup all user info
YThe following info is saved: personal name, user name, encrypted password. The result i s
stored as a textfile in the
To Manager
folder.
;Use the User Restore commmand (below) to restore the users.
Use a copy of the file
User Backup
Times
MacPost 1.1.2
March 12, 1995
page
7 of 12
Palatino
Syntax:
Courier
Command from Manager
User Backup
    Helvetica
$To restore users and info about them
Use a copy of your latest
User Restore
file (created by the
User Backup
command).
Syntax:
Command from Manager
User Restore
personal name
user name
encrypted password
To forward mail
_It is possible to forward all mail sent to an address to another address, or to several another
Kaddresses. This mapping of addresses has to be stored in a text file named
Alias
Postmaster
Wshould be defined in this way. All addresses must be within the default domain (sorry).
Syntax:
(address forward1 [forward2 [forward3
Example:
0# this is a comment (must be on a separate line)
postmaster roland
macpost roland lars_s joakim_b
Misc.
^The MacPost Server is designed to serve a large number of users. A dedicated Mac is considered
^to be a small investement. If you can
t afford a dedicated Mac, then maybe you should consider
another mail system.
DIt is possible to run other applications on the server, but this is
recommended nor
Zsupported. They may not be System 7 friendly or they may crash the server. It may be OK to
*run some other server applications though.
JThe three (four with the Manager) server application should be run in the
background
under
System 7. It is best to
)q"leave the Finder in the foreground
), since the Notification Manager tends to
Ahang the foreground application if a notification alert is shown.
t touch the files in the
Database
)08folder, or you may lose users, or the connection between
users and unread mail.
ZAlthough not supported, it may be possible to run MacPost as a local mail system. To setup
[MacPost for local use, simply set the SMTP Gateway (in the Preferences file) to the MacPost
Server
s own IP name or number.
Times
MacPost 1.1.2
March 12, 1995
page
8 of 12
    Helvetica
Files and Folders
Palatino
aHere is a list of important files and folders. Don
t change any names, modify the tree structure,
etc., or you
ll be in trouble!
Folders are in italics.
MacPost Server
The root
):    AT Server
AppleTalk Server (application)
SMTP Server
SMTP Server (application)
SMTP Client
SMTP Client (application)
Manager
HUnsupported application that make it easier to manage the MacPost server
M(the current Manager is not fully  compatible; it may delete output from some
    commands)
Alias
)List of forward addresses (text document)
Preferences
%Server preferences (ResEdit document)
):    Log Files
6Log files for all server applications (text documents)
Unread Mail
I256 folder (namned
) with all unread mail (in text documents)
Database
Users
%User information (proprietary format)
Mail Index
:Mapping between unread mail and users (proprietary format)
Sequence Number
0Next sequence number to use (proprietary format)
):    Mailboxes
Mail Queue In
Mail to MacPost clients
Mail Queue Out
Mail from MacPost clients
To AT Server
Commands to the AT Server
To SMTP Server
Commands to the SMTP Server
To SMTP Client
Commands to the SMTP Client
To Manager
Commands to the Manager
<Various Script files>
CIn the mailboxes folder you also find several example script files.
Console
Log file
menus
_You may select what is to be displayed in the console window and what is to be saved in the log
*files for each of the server applications.
Times
MacPost 1.1.2
March 12, 1995
page
9 of 12
Palatino
%6There are five settings, and they can be freely mixed.
Show low level info
Show information
Show warnings
Show errors
Show high level info
XWhen low level info is checked debug information is logged. This item should normally be
0unchecked, sinces it can produce huge log files.
'When high level info is checked in the
    AT Server
, information about connected
Jusers is continuously logged every two minutes. Could cause big log files.
'When high level info is checked in the
SMTP Server
SMTP Client
Pcontent (text) in the mail messages is logged. Uncheck this to increase privacy.
MDo not uncheck
Show errors
, and be careful with unchecking
Show warnings
NBy default all items are checked. The settings are saved in the applications.
]Recommended setting are to show information, warnings and errors for all servers and for both
console and log file.
    Helvetica
Backup
It is
Simportant that you regularly make backup copies of important files and folders. You
must backup the
Unread Mail
folder, the
Database
folder, the
Alias
file, and the
Preferences
file. If
Yyou have to restore the backup, it is important that you restore Unread Mail and Database
Htogether, and that the restored versions were backuped at the same time.
ZIt is recommended that you regulary (eg. once a week) shut down the server and make backup
copies of both the
Database
folder and the
Unread Mail
folder.
>You should also regulary (eg. once a week) drop a copy of the
User Backup
command file into
To AT Server
)ENfolder. The AT Server should be running when you do this. The result will be a
textfile in the
To Manager
)?'folder. The contens of the textfile is
User Restore
commands for all your
'users (incl their encrypted passwords).
TUsing Retrospect Remote to backup the server seems to be ok (even when the server is
    running).
)Remember, Murphy is always watching you!
Rebuilding important files
^If you need to restore the important files you can do it in two ways. The second way should be
'used if any of the binary files in the
Database
folder has become corrupted.
The 1st way
Quit the server applications.
Remove both the
Database
folder and the
Unread Mail
folder.
Times
MacPost 1.1.2
March 12, 1995
page
10 of 12
Palatino
Copy both the
Database
folder and the
Unread Mail
)B%folder from your backup into the mail
server folder.
Start the server applications.
The 2nd way
Quit the server applications.
Remove both the
Database
folder and the
Unread Mail
folder.
LStart the server applications. (They will now start with an empty database.)
Drop a copy of your latest
User Restore
command file into the
To AT Server
folder. This
(Ecommand restores all users (with their personal names and passwords).
Drop all mail items from the
Unread Mail
)B&folder of your latest backup into the
Mail Queue
Wfolder. This can take a lot of time. Since there is no information about who has read a
(=mail, it will be added for all recipients listed in the mail.
    Helvetica
Mailing list
\We have set up a mailing list to discuss problems, bugs, new releases etc. about MacPost. To
join it, send a request to
Courier
[e-mail]
(internet)
macpostr@selund
(bitnet)
)To send a mail to the list, address it to
[e-mail]
(internet)
macpost@selund
(bitnet)
BTo send a mail only to the MacPost Development Team, address it to
[e-mail]
(internet)
macposta@selund
(bitnet)
bYou are strongly encouraged to send all questions etc. to the mailing list (ie. don
t use macpost-
Yadmin). We may not have time to answer individual mail. We also encourage you to reply to
^questions submitted to the mailing list (send your reply to the list; others than the original
[author may find it useful). Again, we may not have enough time, and the time we have at our
;disposal may be better spent on bug fixes and new features.
About the Source Code
YThe complete source code for both the client and the server is available at our ftp site.
\If you consider writing a MacPost client for another computer (eg. IBM PC), then consider to
Iuse an existing mail system with SMTP capability for that other computer.
WIf you consider porting the MacPost Server to another computer (eg. IBM PC, unix), then
]consider to use your money to buy a dedicated Mac for the MacPost server, instead of using it
for porting MacPost.
*+,Would you like to fix bugs and add features?
KIf you are interested in enhancing MacPost, please send the following info:
0what feature(s) would you like to enhance or add
Nwho will contribute (backgroud, experience (esp. C, Mac programming, AppleTalk
networks))
7what resources are available (time, equipment, network)
8legal status of your source code changes (copyright etc)
Times
MacPost 1.1.2
March 12, 1995
page
11 of 12
Palatino
;any other information that you may find useful or important
^Please note that we prefer that each part works on major topics. Bugs in other parts should be
]reported to us, so that we can correct them. We would like to avoid having different versions
((with different features and bug fixes).
ZWe will coordinate the various developer teams. It is essential that this becomes a smooth
\process, so that we don't end up spending more time coordinating than it would have taken to
Vwrite it all ourselves! Therefore, we prefer to have well-defined tasks for each team.
]Also note our conditions for the source code. It is copyright Lund University, and may not be
Xused commercially without our approval. You must accept them, and we certainly hope that
`your conditions are similar. It will make things easier if you make your changes entirely public
domain.
    Helvetica
*+    Problems?
If you have problems,
please
) @reread the docs, check your network, ask your local network/mail
^guru, and use the mailing list before you ask us! If you send a mail (see above), please be as
)specific as possible. Log files may help.
The MacPost Development Team
 Lund University Computing Center
Box 783
S-220 07 Lund
Sweden
*Electronic mailing lists (also see above):
    Internet:
[e-mail]
Bitnet:
macpost@selund
DMacPost ftp site: ftp.lu.se (130.235.132.90) in pub/mac/comm/macpost
Times
MacPost 1.1.2
March 12, 1995
page
12 of 12
@    <*]
    84Z@
5*7A!4
#+F9>
1BUVT
.$HRSQ
p 0p`P
 Hp    `0
-*"+,
  @`
5*7A!4
#+F9>
1BUVT
.$HRSQ
-*"+,
    temp.0001
4Bk7T
MacWrite Pro 1.5Sv3
N Helvetica Narrow
Palatino
Times
    Helvetica
Courier
bPREC
nPRVS
zCAPN